Page Templates Reference
Page templates are files that form the skeleton structure of generated output files. Often users will create overrides for these files so that they can precisely control the look and function of generated output files. The most common type of page templates to customize are the Page.asp and Splash.asp files, which are used in most all of the output format types.
Namespace and Attributes
ePublisher defines the namespace: wwpage for page templates as follows:
xmlns:wwpage="urn:WebWorks-Page-Template-Schema"
The following shows the page template attributes that can be used along with their purpose.
Attribute
Purpose
wwpage:condition
Controls when elements should be preserved in the generated output.
wwpage:content
Use this attribute to replace the innerHTML or innerXML of an element.
wwpage:replace
Use this attribute to replace the innerHTML/innerXML as well as the outerHTML/outerXML.
wwpage:attribute-<name>
Use this attribute to emit a generated attribute value with name: name. In addition, you can specify a value of either: relative-to-output or copy-relative-to-output or wwsetting:<target-setting-name>. Specifying the value using relative-to-output is useful for file type attributes that require a pathname relative to the parent file. If the copy version is used, it additionally copies the file into the correct location within the generated output directory.
wwpage:NoBreak
Use this attribute to collapse all white space between two elements into nothing.
wwpage:Import
Use this attribute to indicate an that an import operation will take place using one of the *-from-* wwpage attributes.
wwpage:content-from-file
Use this attribute to import the contents of the specified file as the innerHTML of an element.
wwpage:replace-from-file
Use this attribute to import the contents of the specified file as the innerHTML as well as the outerHTML of an element.
wwpage:content-from-lookup
Use this attribute to import the contents of the specified item name generated by ePublisher as the innerHTML of an element.
wwpage:replace-from-lookup
Use this attribute to import the contents of the specified item name generated by ePublisher as the innerHTML as well as the outerHTML of an element.
Note: If you are using wwpage:attribute-<name> to express attribute that uses a namespace of its own, you can use a "-" character in place of the ":" character. For example: wwpage:attribute-xml-lang is used to generate the xml:lang attribute in the output.
The following shows a typical usage of wwpage attributes within a Page.asp or Splash.asp page template.
Attribute
Example usage in Page.asp page template
wwpage:condition
<hr wwpage:condition="header-exists" align="left" />
wwpage:content
<title wwpage:content="title">Title</title>
wwpage:replace
<div wwpage:replace="content">Page content.</div>
wwpage:attribute-<name>
<link rel="StyleSheet" href="css/print.css" wwpage:attribute-href="copy-relative-to-output" type="text/css" media="print" />
wwpage:NoBreak
<a href="#">
<wwpage:NoBreak />
<img src="myimage.png">
</a>
wwpage:Import
<wwpage:Import wwpage:replace-from-file="scripts/common.js" />
wwpage:content-from-file
<div wwpage:Import wwpage:content-from-file="scripts/common.js"></div>
wwpage:replace-from-file
<wwpage:Import wwpage:replace-from-file="css/webworks.css" />
wwpage:content-from-lookup
<div wwpage:Import wwpage:content-from-lookup="catalog-css"></div>
wwpage:replace-from-lookup
<wwpage:Import wwpage:replace-from-lookup="catalog-css" />
Logical AND/OR/NOT in condition attributes
The wwpage:condition attribute supports both logical AND as well as OR to provide for multiple conditions in a single attribute expression. For a logical AND, use white space as a separator between conditions. For a logical OR, use a single comma as a separator between conditions. The following shows a few simple examples of using multiple conditions:
Logic Type
Example
AND (use space)
<hr wwpage:condition="header-exists company-email-exists" />
OR (use ",")
<hr wwpage:condition="header-exists,footer-exists" />
NOT (use "!")
<hr wwpage:condition="!header-exists" />
AND with OR and NOT
<hr wwpage:condition="header-exists company-email-exists,footer-exists !company-email-exists" />
Working with URL and File Paths in Page Templates
The wwpage:attribute-<name> attribute can be used to specify several behaviors when working with URL and File paths. The following shows the list of available modifiers for this wwpage:attribute.
Attribute Modifier
Example
relative-to-output
<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="relative-to-output"></script>
copy-relative-to-output
<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="copy-relative-to-output"></script>
relative-to-output-root
<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="relative-to-output-root"></script>
copy-relative-to-output-root
<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="copy-relative-to-output-root"></script>
absolute-to-output
<external-graphic content-height="scale-to-fit" width="1in" height="1in" src="url('{wwformat:Pages/images/Logo.png}')" wwpage:attribute-src="absolute-to-output" />
resolved-uri
<external-graphic src="url({wwformat:Pages/images/rms_doc_logo.png})" wwpage:attribute-src="resolved-uri" content-width="100px" content-height="100px" left="0pt" top="0pt" />
resolved-path
<external-graphic src="{wwformat:Pages/images/rms_doc_logo.png}" wwpage:attribute-src="resolved-path" content-width="100px" content-height="100px" left="0pt" top="0pt" />
Using Replacement Types ({}) in Page Templates
In page templates, you can use the {} characters to indicate a parameter to use in an attribute replacement. The {} characters are used to embed a path or parameter within an attribute value. For example, the following is a typical replacement for an HTML img tag, demonstrating how {} characters can be used to improve the result of the replacement.
<img src="url('{images/logo.png}')" wwpage:attribute-src="copy-relative-to-output" />.
Was this helpful?
Last modified date: 01/28/2026